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Fall is definitely in the air here in Missouri. The 
leaves are almost off of the trees, and the ones that 
haven't fallen yet are beginning to dry out. it's only 
a matter of time before a good swift wind blows them 
off. Fireplaces are once again blazing, filling the air 
with that wonderful smell of burning wood. It's time 
once again to bring out the winter clothes, put the 
storm windows up, plan bon fires, and start making 
chili 

The Atlanta CoCo Fest was a huge success for us! 
Mark enjoyed it immensely, despite the eleven hour 
drive each way and the bout of flu he came down with 
the day after he returned. We picked up quite a few 
magazine subscriptions-thanks. I apologize for not 
being there myself, but 1 just started a new job (driving 
a school bus) and was not able to get the time off. I'm 
sorry I missed it and v/ill do everything I can to be able 
ij attend the Chicago Fest in May. 



We Are All Friends 

1 would like to make some comments on the 
subject of ethics in the OS9 community. While our 
September issue was at the printer, Mark received a 
complimentary copy of another magazine and saw 
an article that was submitted to us printed word for 
word in the other magazine. Obviously, the author 
submitted the article to more than one magazine at the 
same time. We apologize. While we are not yet large 
enough to pay our writers for their contributions, and 
thus purchase all rights to the article, we still assume 
our writers will give us the opportunity to print their 
article before sending the identical article to another 
magazine to be printed the same month. We hope our 
readers will not be plagued with this problem in the 
future. 

It was also brought to our attention that a large 
part of one of Mark's articles was reprinted in another 
magazine, word for word, but without permission 
or credit given to Metamorphosis. While we do not 
mind if our articles are used by other magazines, we 
would like to receive credit. Plagarism in any form is 
a serious offense. Besides, it is just good business ethics 
not to do this. Hopefully, this was just an oversight on 
the other publisher's part, and a note of apology will 
appear in their next issue, with proper credit given. 

Our goal, as we previously stated, is to help move 
OS-9 from it's current status as a "hackers" system into 
the mainstream of the computing world. We cannot do 



this if there is any lack of professionalism on the part of 
the players. We must develop an attitute and working 
relationship as a knowledgeable, professional group 
of computer scientists and satisfied users. Anything 
less will hurt our chances of being accepted into the 
global community of computer users. Let's please all 
work together to accomplish this. 

Future Plans 

Mow that the introductory period is over, we can 
cater soley to our paid subscribers. We have some 
plans for the future that we hope our readers will 
rind enjoyable, For example, we're in the process of 
negotiating to get a special area on one of the major 
telecommunication services to upload all of our 
articles and source code listings so our readers will be 
able to download them at their convenience. We're 
also making arrangements to provide our readers 
with more mdepth articles and product reviews than 
what we have previously provided. These are just 
a sampling of the ideas we have in mind to try to 
make your subscription more meaningful and more 
enjoyable. We hope you will be pleased with the 
results. 

As always, we hope you will continue to write us. 
Your suggestions and kudos are most welcome. Have 
a frightfully funfilled Halloween! 
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Mail Call! 



Subscriptions Keep Coming In 



Barbara, 

Please sign me up with No Name (which is now 
named but I cannot remember what). Mark is one of 
the few who does things instead of talking about thetn, 
and I would like to keep track of what he is up to, 
even if it is OSK. Check enclosed. Your comment to 
Desertfox leads me to believe there is a stamp collector 
in your house, A month or so ago we bought some 
1960's Science Fiction at the auction at .50 each, and 
when 1 read two of them I found some stamps between 
the pages. Since I have been inactive for 50 years, and 
the collection was stolen about 10 years ago by one 
of those buyers, I am including them plus a couple 
duplicates from my envelope. Good luck with ail your 
projects, 

Herbert L Peterson 
Ckmenton, New ]ersey 

Say, Herbert. What a nice guy to send us the stamps (and 
the subscription, of course). We had a great time looking at 
all of than. My son lias stashed them away in his room with 
the rest of his collection. He was very excited to receive such 
rare stamps and says to tell you thanks -Barbara 

Dear Mark and Barbara, 

After reading the four free issues of your 
magazine, I am very pleased with what I have seen so 
far. It's a good feeling to know that there is still strong 
support out there for the Coco. I am enclosing a check 
m the amount of $24.00 for a year's subscription to 
your magazine. Keep up the good work. Thank you. 

Lee Stover 
New Hampton, Iowa 

Dear Mark and Barbara, 

I've enjoyed the three free issues of the 
No Name Magazine you provided to illustrate the 
quality and content you intended to publish. I believe 
you have a winner! Enclosed find my money order for 
a subscription. Keep up the good work. 

Dave Kelly 
Arlington, Texas 

Dear Mark and Barbara, 

The second issue that I have received of NoName 
magazine arrived the other day. 1 definitely want to 
continue getting it Thus, a money order for $24.00 is 
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enclosed. Keep up the good work! 



Julian P. Belt 
Massachusetts 



Mark Griffith, 

Enclosed you will find two money orders. The 
first is for $24.00 for the first year's subscription of your 
new magazine Metamorphosis.... I do hope everything 
works out. 

Paul K. Myles 
Pennsylvania. 

Dear Mark h Barbara, 

Thank you for the free issues; I found them very 
enjoyable and informative. I look forward to receiving 
many more issues in the future with an expanded 
coverage of the MM1, 1 hope. 1 went from a CoCo II 
to a CoCo III, and now I am currently using an MMl . 
As you may well imagine, I was a subscriber to the 
now defunct Rainbow magazine. Please find enclosed 
a check for $24.00 for a one year's subscription to 
your new magazine \ wish you great success in your 
efforts, and hope 1 will be renewing my subscription 
to a thriving publication. 

lames L. Gifford 
Kingman, Arizona 

To all of you who have decided to stay tlie course, zve thank 
you very much for your support and subscriptions. We too 
hope Metamorplwsis will be a thriving publication. As we 
continue to learn as we grow, the magazine will only get 
better. Keep your letters coming -Barbara 



We goof again! 

Mark or Barbara, 

Enclosed is my check for a subscription to The 
NoName Magazine. Also, I would like to point 
out that my last name is spelled correctly on the 
mail address label, but in the June 1993 issue it is 
misspelled. See you in Atlanta, Mark? 
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William L. Wittman, /r. 
Buffalo, New York 

Oops! Terribly sorry about that, William. I am trying very 
hard to catch those boo-boos, but there always seems to be 
one or two tlmt get by me. I hope practice makes perfect 
applies when it comes to proofreading. Thanks for pointing 
this oat -Barbara 



News Clips 



Atlanta Success! 

The 3rd Annual Atlanta CoCoFest took place 
during the weekend of the 2nd and 3rd of October. 
Alan Dages and the Atlanta Computer Society again 
put on a wonderful show. Attendance was a little 
low this year than in times past, but those that came 
brought along their hard earned dollars and they were 
ready to spend! Many new and exciting products 
were displayed, bath on the showroom floor as well 
as in the individual rooms after the show closed for the 
day-products in the making. 

One thing that was apparent during the show 
was that CoCo products were less in demand and the 
MM/1 and OSK products were the ones that sold. It 
seems that CoCo Level 11 support may start dropping 
in favor of the more advanced systems. Only increased 
user support can prevent this, or at least slow tht- 
progress. Users, support your software and hardware 
developers' Developers, work on producing more 
quality products for your customers! Support OS-9! 
Support the CoCo! Support them all! 



Chicago Fest Announced 

The 3rd Annual "Last'' Chicago Fest was recently 
announced as a go by the Clenside CoCo Club's 
president Carl Boll. It looks like the weekend of 
the 28th and 29th of May, 1994, will be the time, the 
Holiday Inn in Elgin, IL the place. More news will be 
posted when available. 

In The Next Issue 

The November issue will feature several new 
articles. In addition to Shaun Marolfs excellent series, 
a review of Speedisk, Brian White's new disk optimizer 



will be featured. The Hardware Hacking column will 
reappear with myself as the feature writer. We'll try 
many hardware tidbits over the next several months. 
Hopefully, you'll enjoy all of them. See you then! 

Mark Griffith 
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Keyboards, AT/XT switchable for 
your Sys4 or Sys5, MM/1 or Kix or 
even PC Compatible. Extremely 
small footprint $5995 

C Micro Charts, C functions and 
syntax at your fingertips, spIH- 
proof laminated plastic .... $6.50 



r For CoCo 512*.' OS-9 Level 2 Machines — 

DCom (Basic09 Decompiler) 
Now shipping V3.1 ..... $24.95 

TShell (5 times faster tnan Muitl-Vue) 
Text-based "GUI*. Displays more Info on 
your screen tiian MV does $1 9.95 

C!oud„09 (Graphics/Animation Paicg) 
Save/Edit/Load VEF Pictures and Animate 
trsem $19,95 



y~ For OSK Machines; - 



OSK TOOlKft (Utility Pak for OSK) . $9.95 



Underground subscribers take 20% Off 
these low pricesr include your member 
card number when you order. 

*(Exceot Keyboards) 



<Check or M.O r sorry no plastic or COD) 
Piease Include $1.50S&H wrth your order 
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4650 taftuenga Eilvd; Sbe-0 
Toiuca take, CA 91602 
(81 8) 761 -41 35 (vofce) 
(SIS) 165-0477 flax) 7 
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„ The Art of 
Programming 



Part W 
Language Syntax 
by Shaun Marolf 



Shaun Marolf, 30, is a member of the 
US Navy stationed at Naval Air Sta- 
tion San Diego zuliere he is current- 
ly working on his degree in Comput- 
er Sciences. He first learned program- 
ming in 1979 on an Apple II Plus and 
is also schooled in electronics and dig- 
ital circuits, Shaun runs the "Eight 
Bit Heaven" BBS (619-447-2111) and 
owns several computers, including an 
original grey case CoCo 1 . 




Syntax: la. The way in which 
terms are combined to form phras- 
es and sentences, b. The branch of 
grammar dealing with the forma- 
tion of phrases. 2. The rules gov- 
erning the construction of a ma- 
chine language. 

Syntactics: The branch of semiotics 
that deals with the formal proper- 
ties of signs and symbols. 

Defining syntax is easy. Ex- 
plaining it isn't. To begin with, 
let's discuss the language of the 
computer. The computer knows 
only one language, that of bina- 
ry code. The computer knows the 
numbers one and zero, (the states 
of on and off, also called hi and 
low.) Flow the computer stores 
data and programs is a series of 
these registers. Each register is re- 
ferred to as a bit. Eight bits put to- 
gether form a byte. 

How a computer translates 
the information you give it into bi- 
nary code is done through a trans- 
lation program. This program is 
usually in the operating system of 
the computer. Language transla- 
tors work by taking the language 
you are working in and translating 
it into the binary control codes cor- 
responding to the instruction you 
give the computer. The problem is 
the translator requires a perfect set 
of instructions to be able to give it 
to the computer in its appropriate 
binary code. The syntax and syn- 
tactics must be absolutely perfect 
in order for the translator to do its 
job correctly. 

Understanding this, it is 
important to note that most errors 
are caused by syntax errors. Now 
this is not to say you have to 
make sure that every line is correct 
before hitting the enter key. That 
would be asking the impossible. 
However, it is important to be 
prepared to go back through the 
code to find the error. 

Each programming language 
is in itself unique from any other. 
The C language is considered 
to be one of the most powerful 
languages used today, but for all 
its power, it takes a great deal of 
time to learn. (Also, for all the 



hype about portability, it's not 
quite as portable as it should be.) 

Basic is an extremely simple 
language and takes little time to 
master. However, it lacks the 
ability to do some of the more 
advanced features other languages 
offer. It also is extremely slow as 
each line is translated while it's 
running the program. 

There are several other lan- 
guages as well, each having 
strengths and weaknesses. What- 
ever language you do decide to 
use, you must learn the syntax 
structure used by it in order for it 
to understand what you want it to 
do. 

Another problem is that no 
I wo versions of any language are 
the same. Also, there are different 
standards for languages. Case in 
point, there is K and R and ANSI 
standards forC. 

This creates several problems 
for programmers and requires 
one to decide which version and 
standard he or she wants to use. 
Once decided, get ail the available 
information you can on it, from the 
generic material to the detailed. 

Study, learn, follow the ex- 
amples, etcetera. Remember that 
methods and techniques constant- 
ly change, in order to remain 
competitive you must keep up 
with them. Also, if you use 
a language, such as C where 
you need module libraries, locate 
and acquire as many as possible. 
Good sources for these are BBS's, 
networks, programming organiza- 
tions, and workshops. 

Once you start learning how 
to program, you'll find that it 
never really stops. Things happen 
and change so quickly that you'll 
find yourself constantly learning 
new things. 

Next month we'll discuss 
the two most used programming 
structures. 
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DA-CHART 

A program for keeping 
your children busy 

by Tom Kowahki 



Torn Kowalski, 46, likes io write 
BASIC programs on the CoCo and 
then convert them to BASIC on an 
Apple and 71-99. While not messing 
with his computers, he enjoys fishing, 
gardening, cooking. Tom has served 
as the doorman at the last two Chicago 
Pests so many have met him without 
knowing it . Tom works as a Associate 
Product Engineer and produces CAD 
documents on an IBM 5080, 



DA-CHART is a short pro- 
gram to print a chore chart on an 
Epson printer. The minimum re- 
quirements needed to run it are a 
CoCo HI, a single disk drive, a seri- 
al to parallel converter cable ( to go 
between your CoCo and the print- 
er), and an Epson 24-pin series LQ- 
500 printer with multiple fonts. 

This is a 'load and run" 
type, and, 1 think, user friendly. 
I used a single command per 
programming line approach when 
I wrote it (it took me over two 
months). Quite frankly, I got 
lost trying to figure out what 
happens in a multiple command 
line, as many of the CoCo basic 
programs are written (remember 
the "one-liners'"?). Since this is 
my hrst MAJOR basic program, I 
tried to make it as easy as possible 
for a novice to read through st and 
understand what each line does. 
Also, in a future version (programs 
are NEVER finished), 1 want to add 
programming notes to the lines, 
to aid others in stepping through 
it. I also incorporated a ''block" or 
"module" type of programming, 
as evidenced by the line numbers. 
This helped me to write, run, 
and debug the program, and also 
to understand more fully how 
the GOTO and GOSUB routines 
of basic worked. The program 
will prompt you for the following 
information; 



child's Kama 
Month 

Data, begin witfc Sun 
Mbr o£ Chora e {Max 3) 
Chore Name {max 15) 
Money Value of chore 
Printer Baud Rate 
Typo (Font) Style Cart 
Type (Font) Selection 



(line 80) 

(line 120} 

(line 150) 

(line 200) 

(line 250) 

(line 280) 

(line 1130) 

(line 2500) 

(line 2650 
or 3020) 

(line 3220) 



Draft or LQ 

Print Another Chart 

using existing params (line 5620) 

You cannot default past any 
of the prompts in the program 
by hitting "enter." You must 
answer the prompts by entering 
the appropriate letter response, or, 
if it is a user defined entry, such 



as "Child's Name", just hit the 
spacebar a few times, then "enter." 
If you do not, the program will just 
loop back to the prompt and wait 
until you enter correctly. 

If you exceed the maximum 
number of chores, the screen will 
change color, give you a beep 
and a reprimand, and then loop 
back and ask you again. A similar 
situation will occur if your chore 
name exceeds fifteen letters. 

[ tried to offer as many op- 
tions as possible, based on my lim- 
ited programming abilities . I al- 
ready see a few more options 
and refinements to make to DA- 
CHART, and I will be working 
on them, A program is NEVER 
n rushed !! 

1 also used color screens and 
sound to help Jet the user know 
what's happening within the 
program. The program will also 
check to see if the printer is on-line 
(lines 10011-10201210-1250). The 
main print routine body is in lines 
5000-5570. 

The program will require a 
full sheet of paper to print on, no 
matter if there is only one chore or 
the maximum of eight. 

When I demonstrated DA- 
CHART at a meeting of the Glen- 
side Color Computer Club, the 
members saw many different pos- 
sibilities and applications for my 
program. I would like to encour- 
age the users to write programs for 
the 24-pin printers and, now, more 
than ever before, for the CoCo, us- 
ing DA-CHART as a platform to 
start from. I would like to hear 
from you if you do. If you run into 
a problem or get stuck, I will cer- 
rtainly try to help, just as I received 
help and encouragement from fel- 
low CoCoists. 

I want to encourage those, as I 
was encouraged, to try their hand 
at programming. There's lots of 
help out there....don't be afraid to 
ask on your local BBS or at a club 
meeting. This is what we need to 
help our orphan CoCo survive and 
flourish. Enjoy it! 

(Source code beings on next page) 
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CLEAR 5000: RGB: WIDTH4G: CLS6 

2 PR TNT ***************************** ********** 

4 PRINT 1 **** ** 

5 PRINT***** DACHART ** 

6 PRINT****' FOR USE WITH THE COCO III ** 

7 PRINT'**** & EPSON PRINTER SERIES LQ-500 ** 

8 PRINT'**** VERSION 2.0 •* 

9 PRINT"**** BY TOM KOWALSKI *" 

10 PRINT'**** 104 RTDGE CIRCLE 

11 PRINT" **** STREAMWOOD, IL, ■ 

12 PRINT"**** 6010'? -1704 

13 PRINT***** COPYRIGHT (C) AUGUST * 
140 PRINT: TO INT •ENTER DATE, STARTING WITH* 
150 INPUT 'SUNDAY'S DATE: *;MD$ 

160 IF ME>$ = * ' THEN MD$= ■ 
19U PRINT* ENTER NUMBERS ONLY ■ 
■200 INFJT MOW MANY CHORES ';C 

210 IF C%8 THEN SOUND 140,3; SOUND 10C,5:GOSUB 500: GOTO 190 
.20 PRINT 
230 CLSS 

2*0 PR I NT "CHORE NAME • 
2 50 LINK INPUT CNSttil 

2 b IP LBN < CN$ ( O i ) > 15 THEN SOUND 1 '5 , 2 : SOWD 90,2: GOSUB 
550; GOTO 240 

270 PRINT* MONEY VALUE " 
2ao INPUT MV$(OJ 

34 IF CN$(Q)^ ■ ' THEN GOTO 1000 
i00 IF O-C THEN GOTO 1000 

310 o-Q--: 



J 20 GOTO 230 


v-.o -: 


;LS;WIDTH32:END 


50 CLP 8 


510 PRINT'TM., PROGRAM WtLL ACCEPT A MAX. 


520 PRj-MT" OP » COOPE.'J TO PRINT rVP.PECTi.Y 


SJ'1 Hi/iURN 


;;50 ( 


:ls 4 . 


c , 6 


'HINT" *** TOO [ONG *** * 


5 '70 Pit TNT* MAXIMUM OF 15 LETTMW 


530 PRINT' r 'LEASE RE-EUTER* 


59 RKTURM 


1000 


CLS'o 


" <">! 


3F'-.-:PEEKib^U'i) AMD 1 


1020 


IF C-P>0 THEN GOSUB 1210 


1 ? ; ^ 


'"LSi, 


;o4 r ) 


'** PR I NT" EH BAUD RATES ** 


1050 


PRINT' PRINTER BAUD P.ATES- 


100 


PRINT 


1'JVO 


PRINT" A ^ 9600" 


1030 


PRINT* B - 4800" 


'O'JO 


PRINT' C - z400" 


j 1 


PRINT' D - 12O0« 


U10 


PRINT" E ■ iOC 


1 !70 


PR : NT : PR L IT P " ENT £R i , F TTER ' 


1 130 


<<$-INKSY$ 


i;40 


IF X$. " THEN 1130 


1150 


. ? K$ - ' A * THEN POKEl 50 , 1 ; GOTO 2 T 1 


1160 


IF K$-.'fi # THEN POKE150.7: GOTO 2.3 00 


117 


CF K.$ = *C* THEN POKE150.38: GOTO 23 U0 


litfv' 


IP K$ - * O ■ THEN POKE ' 5 , 4 I ■ vWO 2300 


ll'-'O 


IP' K $ -- ■ E " TK EN POX E 1 5 , 3 ' ,' : GOTO 2 3 


1200 


SOUND 90.10: GOTO 1130 


L210 


OLS4 



t220 PR I NT 'PRINTER OFE LINE* 

1230 SP=PEEK(65314) AND 1 

1240 IF SP <> THEN 1230 

1250 RETURN 

1500 PRINT 

2-300 ' * * * TYPE 3TY LE FAMI L ¥ * * * 

2310 CLS2 

2 32(1 SOUND 110,5 

2 330 PRINT: PRINT: PR INT" YOU MUST HAVE THE PROPER FONT" 

2140 PR INT "CARTRIDGE TO USE OPTION!" 

2 350 PRINT' 2 THRU 9" 

230 (j PRINT 

2 370 PRINT: PRINT' 

2380 PRINT: PRINT" 

2390 PRINT" I 

2400 PRINT' 2 

2410 PRINT' 3 

2420 PRINT" 4 

2430 PRINT" 5 

2440 PRINT" 6 

2450 PRINT* 7 

2460 PRINT* 8 

2480 PRINT: PRINT" 

2400 PRINT: PR INT" 

2500 INPUT TSF$ 

2510 IF TSF$--"* THEN GOTO 2500 

2520 IF TSF$^*N* THEN GOTO 2600 



TYPE STYLE FAMILY" 
- ROMAN 1 
SANS SERIF" 
COURIER* 
PRESTIGE* 
SCRIPT" 

■ OCRS' 
OCR A" 
ORATOR* 

■ ORATOR- S" 

DC YOU HAVE THE PROPER 
<Y>ES OP <M>0 " 



2530 IF TSPS= , Y' THEN GOTO 2900 ELSE GOTO 2540 

2540 SOUND 130,5: SOUND 110 f 5:GOTO 2500 

2600 CLS7 

2610 PRINT: PRINT' TYPE STYLE FAMILY" 

2620 PRINT; PRINT* - ROMAN" 

2630 PRINT' 1 - SANS SERIF* 

2640 PRINT: PRINT: PRINT: PRINT* ENTER NUMBER" 

2650 INPUT TS$ 

2660 IF T3$="" THEN GOTO 2640 

2670 IF TS$="0* THEN X(1)=0: GOTO 3150 

2680 IF TS$-*1* THEN X(l}-1: GOTO 3150 ELSE GOTO 2690 

2690 SOUND 130,5: SOUND 110,5; GOTO 2650 

2900 CLS5 

2910 PRINT: PRINT'FULL TYPE STYLE FAMILY" 

2920 PRINT: PRINT" - ROMAN" 

2930 PRINT" 1 - SANS SERIF" 

2940 PRINT" 2 COURIER" 

2950 PRINT" 3 - PRESTIGE* 

2960 PRINT* 4 ■ SCRIPT* 

2970 PRINT" 5 ■ OCR-B* 

2980 PRINT" 6 - OCR-A' 

2990 PRINT" 7 - ORATOR* 

300O PRINT" a - ORATOR -S" 

3010 PRINT" ENTER OPTION NUMBER* 

3020 FTS$=INKEY$ 

1030 I? FTS$--='" THEN GOTO 3020 

3 U 4 IF FT S 5 - " * TH EN X ( I i -•= : GOTO 3 1 5 

3 050 /F I'TS$-"1* t'HSN X(l}~1:GOTO 1150 

3060 IP PTS S - " 2 * TH EM X ( 1 ) ^ 2 : GOTO 4 5 

3 07 i F FT S $ a : 3 * THSN X ■ 1 i - 3 : < iO'l'O 4 C 5 (1 

3 030 I F vvn$-*4' TH EN X { 1 ) -.- 4 : GOTO 4050 

i0*»0 IF FTS$--"5" THEN Xt 1)^=5- GOTO 4050 

3 1 00 I c FTS $ -^ • 6 " Tm FN * { 1 ) -. 6 ■ GOTO 4 050 

*I10 r F FT ■ > > - * 7 * TH EN X( 1 J-.7- GOT' > 4 5 C 

3120 IF "TJJ--!*S - THEN XMi.-E; OCTO 4(:!i0 S/.ciF OOTO 3U0 

u:o .3crjtoo i> i 5.iu; kcunij loo.Si goto i0.";0 

.1150 •"*« PRINT STVLF. **■• 

3 i vSO CLS5 

.< i 70 PR TNT . PI- INT : PR tNT * PF irrr STY L-T. ' 

3 i M PR I NT : PR I NT ; PR I N' L ! 

3130 PRINT" D - CRAFT" 

3 200 r^INTtPKINT" L LETTER QUALITY* 

3210 pRlOTrPRim'iVRlNT" ENTER LETTER" 

i32.". PS'J-INKEY? 

32 50 IF PSS^-- '" TilEN GOTO 3 270 

a 2 40 I? 93$-- -D" THEN GOTO $2/0 

3250 iF ?3$- "L" THEN GOTO 32 HO ELSE GOTO 3260 

3260 SOUND 9 0,10: GOTO .J 320 

3270 xU)r0. GOTO 1000 

3 vRC Jt(2)-J r GOTO 4000 

4 ^R INT* - 2 , CHR S ( 2 7 > CHR $ ( 12 > CHm $ ( X ( 2 I J 
4'JiO GOTO 5000 

•10^0 PRI NT# - 2 , C7 IP $ { 2 M CHR? ; i 7 ) CHR $ ( J£ ( 1 / ) 
40f,0 OOTO soon 
5000 OL.S5 

5 1 PR i NT " PR J NT I NG ■ 
5020 PRINT*- 2 

5040 PRim-* - 7 , CUR J {27 } CURS (113) CHR$ ( 3 v ; CKR"? . 27 ) CHR$ (71) 

5 050 pft! NT * 2 , TA 6 ( 2 > C FN $ "3 C HOR E AND Ab LOWANC B HE POR T 

=•061- PRINT* 2 ; TAa{25) "WEEK BEGINNING "N$" /'MD5 

e- 070 PRINT* 2 , CURS ( 2"M CHRf t i 1 3 ) CRR$ { ) ; CHR$ ( tf i CHR5 (1161 

CHS$(0t) ;CHH$i27)CHR$ (54) 

b 11 X $ --STR IW35 ( 1 5 , ?HR? ( 2 S } ) 

5120 Y>-.TrRING$-;5,CHR$(20S) ) 

5130 ^£:: ; STRING$a2,' ( HR$(20^)} 

5140 BX$---" 

51 SO BY$ = * 

5160 S2$=" 

5170 PRINT#-2,TAB{2iCHRS(a01)X$CHRS(a03)YiCHR$'203) 

YSCHRS ( 203 ) Y$CHR$ 1 203 ) Y$CKR$ {203 ) YSCHHS ' 203 J Y$CHR$ {20 3 ) 

Y$CHR$(203>Y$CHR$(20:nZ$ClIR$ilr37) 

5180 Ml$-:" CHORE *• 

5190 M25-" SUN * 

5200 M3$-.' M^iN " 

5210 M4$-* TUB • 

5^20 MTj$=" WED s 

5230 M6$^* THU " 

5240 M7$*" FRI * 

5250 M9$-v" SAT " 

5260 M9$^* TOTAL AMT. ■ 

5270 MX$=«S AMT" 

5280 PRINT* -2 . TAB ( 2 ) CHR$ ( 186) Mi $CHR$ (18 6) MX$CHR$ { 1 S6 \ 

M2$CHR$ ( 186 ) M3 $CHR? ( 186 ) M4 $CHR$ ( 186 ) M5$CHR$ (186) 

M6SCHRS(186)M7SCHR$(L86)M8$CHR$(IB6)M9SCHR$(186) 

5290 PRINT* 2,TAB(2)CHR$(204)X$CHR$(206)Y$CHR$<206> 

Y$CHR$ (206 ) YSCHR$ ( 206 ) YSCHRS (206 ) Y$CHR$ ( 206 ) Y$CHRS ( 206 ) 

Y$CHR&(206)Y$CHR$(206j2$CHR$tl85) 

5300 R=l 

5310 POR Q=l TO C 



- Metamorphosis - 



5,3(30 PRINT*- 2 , TAB (2) CHR$ { 186 ) CN$ (Q) TAB (18 > CHR$ {186 ) 

TAB(19)KV$(Q)TAB(24)CHR$U86)BY$CHR$(186)BY$CHR$(136) 

BY$CHR$ ilB6) BY$CHR$ ( 186) BY$CHR$ ( 186)BY$CHR$ (196) 

BY$CHR$U86)BZSCHR$(186} 

5i40 PRJNT#- J,TAB(2)CHR$(186)BX$CHR$ (204) Y$CHR$ (206) 

Y$CHR$ (206) Y$CHR$ (206) Y$CHH$ (206) Y$CHR$ (206) Y$CHR$ (206) 

Y$CHR$ (206 ) Y$CHR$ ( 206 ) Z$CHR$ ( IBS ) 

5350 PRIOTt-2,TAB (2)CHR$ ( 186 JTABU8 |CHK$ ( 186) TAB (24 ) 

ChH$ ( 19 6 ; TAB ( 3 JCHRS ( 186) TAB (36 ) CHRS ( 1 86 ) TAB (42> CHR$ i 186 ) 

TAB{4S)CHR$(186)TAB(54)CHRS(186)TAB(60)CHR$(1S6>1 , AB(66) 

CHRS US 6 J TAB (79 }CHR$ (186) 

5360 PRim*#-2.TABt2)CHRS(186)BX$CHR$(204)Y$CHR$(206) 

Y$CHRO<206)Y$CHR$'.206)Y5CHR$<206)Y$CHR$(206)Y$CHRS(20fc; 

Y$CHR$(206)Y$CHR$(2G6)Z$CHR$(185) 

5 J70 PRINT*-* , TAB(2/ CHR$ (196) TAB (18) CHR$ ( 136 ) TAB (24 J 

OIR$(ie6jTAB(30)OHR5(186)TAD(3 6>CHR$(ia6)TAB(42JCHRS(196) 

TAB ( 4 8) CHB$ (186 ) TAB ( 54 i CBR$ OB6 ) TAB { 60 ) CHRS ( 136 ) TAB (66 } 

CHRS U36 i TAB { 73 } CHR$ ( LCfi> 

5*30 IF K.--C THEN JOTO 5500 

5385 R-R+3 

b390 PHTrmt-2,TAB(a)CHH$(204>XSCI!RS(206)Y$CHft${206) 

Y?CHR?i206) YSCHH$(206)Y$CHRS{29fi)Y$CHR$(20t>)Y$CHi«S(2C6) 

Y5^HRS (20e>YSCHR$(20t))S$CHR$ (185) 

ViOO NEXT «2 

5500 PRINT* -2,TAS{2)CHRS (200)XSOHR5(2G2) Y$CHH$ {2021 

YSCHR5U02! Y$CriR$(2O6}Y$CIiR$i2O2)H$CHR$(202i Y$ChR$(202) 

^CHF 4 ( 202 ) Y$CHR$ ' 20t» i :'.$CHR$ { 135 ) 

5^;C M"-'.S=- TOTAL AMOUNT FoK THE WREK* 

2 5 iO V F I !JT* -■/ , TAB (36) <"HR$ ( lSt ) H?.$TAr!. 16M CHR.> I 186 J TAB (79) 

■■:h;.5( 166) 

554U PR ! NT* -2, TAB { !6 iCHR$(2C0) y$C;{R<;: (205; -t$CHRS (205 ) 

Y = k\ L IR$ ' -i 'J i ) Y$CHRC ( 2 5 ) V $CHR? ( 2 0o ) l'.$r^s$ (185) 

-j> b 5 en. [JJT4 2 , TAB (54) CIW > ( 1 3 6 ■ HB-5TAB (66; \.*HR5 ( ] 6 i 

B/dCMHj. 'Jj<;j 

;CHR$,202i 



5 -- 5 


fc-^ ] »'I * 2 , TAB (54) CrikS { ; 


00) *$C'H4$ (205 )Y 


/.>'■»<; 


$ llfltf! 




55' 7| J 


PWTIIT#-2,CHri$;i2) 




5600 


KRl^T. PRIMT: PRINT" 


r'RIMT ANOTHER* 


5610 


t'KINT-.-KifJT' 


CHORE CHART '." 


5 o i 5 


.-l-'il-il : rk.'^v* 


VES OR HO 


5 62'-) 


LjME INt'UT l'A$ 




56".0 


IF eA ?-■• THEN KNT 




5 610 


Ji" P*.$- *N" THEN END 




5^50 


IF FA$^'YV- THEN GOTO 


5000 



CdCo Products 

i cow fMsicas 

Program in 3astc09 with icons'! 
HI & LO RES JOYSTICK *4lMP7ER 

High or Low resolution a'- the flip of a swUc;h! 
DU^f. HI RES JOYSTICK ^D^PTER 

Hj^h (aS 2r Color* are) or Low i-eiolut'ion' 

3 foot kevtoarrt sxtensio- cable' 
My SOS 

tr>e commands Tandy le? r - out, Support* RS Spaecn Pafc! 

MM/1 PRODUCTS 
XCQJi B*mC/5BQ0O 

Program Microware Dasic with icons! 
SOUWD wr 1.2 

Record, Play, and Edit sound files thru the sound port! 
MM/t SOUWD 1MBLE 

Connects sound port to stereo equiDment. 

KLOC)C 

Con uncus an screen digital clock display 

Please note our new aadress: 



$20.00 
127.00 
$40- GQ 
$2300 
$!5.n0 

$2500 
$2000 
$3000 
$1000 




HflWKSoft 



244 S. nAfiTsALL P.OAX3 SUXTE #J72 

ELGIN. ILL 60123 

(708) 742-3084 eves and *nds 

US 4 CDN SftH always included. Terms: Ml), checR, or CGD in US funds 



ining style, one in which the programmer relies 
cm Ihe 'computers processing power instead of 

; ; •letJ^-'d)rectly;to' Utge ong^. ''/..;•;..••.'.; 
algoritkn is associated with the traveling 

Suppose a person is in Boston and wishes to 

:: -;diiveiio;-M,^ 

; ; c^ppari>^ -^:|S|p!fe?fe J ; : W^ile; g^rarite#i : : :tb : - 
wosi^ and siBtpi^j : to implements -tJife algori thm 
is .dearly -very- shipidin-that it considers even 
obviously absurd routes (iik^ going from Boston 

.-■to. HOT^on.'.via. San. Francisco -aiad .N^w-Yorfc- 
in that oider}, For very ^maw N it works welV 
Mt i'\i\ rapidly becomes absurdly ine?Hcit>nt 
when N-increases-<fcrN - 1.^ there sire already 
+j,W&74&6&$»- possible routes to consider, 

"i-;:' ■ WJ^.hef • brttte^rce prograntitii ng should 
be considered stupid or not depends on the 
context; if the problem .ten- Hop big, X\iq extra 
CPU time spent on a brute-force solution may 
coft* le$$ th^n the- programmer tinte it wotild 
take to develop a more •mtelligeitf algoritbm/ 
Alternatively; a ^more inteJHgent algorithm may 
imply More long-term complexity cost ^aind. 
bug-cha$i|ig th$n : are ju^dfi^d by the speed 
•;::;;;;i^pt^^^ 

TV jj^/iT^^scm^/cb^ is;' : 

dtitibt^ use finite fece"^ He probably intended 
thu* as -a {ha hai ojtitjr ^eriou^K but tl^ oi^irtai 
UNIX kernel^ preference for simple, robust, 

•; m&: $&<^^ ^^ -^ 

other tradeoffe in software design> the choice 
between brute force and complex, finely-tuned 

\XM<$^^ and 4^1^^:^^':; 
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FightingThe 

Hard Drive 
Monster 



Adventures with a 
PT-68K 

by David Wordell 




I recently bought a case and 
power supply from the local com- 
puter flea market. Got a good deal 
on it, too. A real nice case and 200 
watt power supply for just $40.00. 
I then ordered the FT 68K-4 Sin- 
gle Board Computer from Periph- 
eral Technology, Marietta, Geor- 
gia. I also ordered Profession- 
al OS-9/68000, version 2,4, by Mi- 
cro ware, from the same company. 
i also bought a 3 1 / 2 inch 1 .44 Meg 
Floppy Drive and installed this in 
the new case Got it at the same 
flea market for $43.00. When the 
circuit board arrived, I put it in my 
new case and plugged in the pow- 
er supply cables. I also installed 
the little cable which brings Com-i 
to the rear of the case so that I could 
hook the CoCo to it and see what 
this baby could do, Everything 
went well until I hooked the Flop- 
py Drive cable backward on the 
mother board. Scratch one boot 
disk. Actually, not that bad. It 
just messed up two files, it so hap- 
pened that they were hdsetup and 
hd form at. Now, after getting the 
cable hooked up correctly, I could 
boot up but was unable to get the 
hard drive running. Oh yes, I had 
a 72 Meg, full height hard drive on 
one of my CoCo's that 1 decided to 
install on this machine. Tins was a 
minor inconvenience, and Freder- 
ic Brown of Peripheral Technology 
graciously sent me another boot- 
disk. 

The new bootdisk soon ar- 
rived, and 1 set out to install the 
hard drive. Following the instruc- 
tions, I created a new /h0 descrip- 
tor for it and proceeded to format 
it. The key phrase here is "fol- 
lowing the instructions/' All went 
well The drive was ready, and 1 
used Dsave to copy the three disks 
Rill of OS-9 goodies to it. By the 
way, I found many familiar names 
of utilities that we have on the 
CoCo and, to my surprise, many 
have improved features. I felt re- 
ally "at home" with this new OS- 
9/68000. 

Let's go over what I had up 
to this point. The mother board 
is installed . There is a cable with 



a female DB-25 connector coming 
to the rear of the case to hook the 
CoCo to. There is a 3 1 /2 inch, 1 .44 
Meg floppy drive installed. There 
is a 72 Meg hard drive installed. 
To run this machine, I power up 
the CoCo and run SuperComm. 
I set the baud rate to 9600 and 
the terminal type to OS-9. Then 
I power up the PT 68K-4 and a 
menu appears, I choose number 4, 
Boot from Floppy, and I'm off and 
running. 

I happen to be taking a course 
in C programming so I had to 
try out the C compiler. The first 
problem I encountered was that 
unless 1 decided to retype all my 
source code, 1 didn't have any 
way to get these tiles to the new 
machine. I finally did find a way, 
but it is not pretty. First, did to 
the ram disk on the new machine. 
Then type "build source.c" and the 
familiar ? prompt will greet you. 
Then flip to another window on 
the CoCo and list the file source.c 
and redirect it to SuperComm' s 
serial port, by typing "list source.c 
>/t2" Return to the window 
running SuperComm and you see 
build taking the text as if you 
had typed it in directly There 
was a problem, however. Each 
line ended in 0D0A. OS-9 prefers 
0D only, 1 found this out by 
using the Dump utility. Works 
just like the one on the CoCo. 
This made for a messy listing, 
not to mention the C compiler 
getting all choked up, 1 looked 
in an ASCII conversion chart that 
was in my printer manual for the 
value of OD and OA. 1 found 
that OA was called Ctrl I in that 
chart. Guess what? By using 
edt, just like edit on the CoCo, I 
could get rid of the "Ctrl-J's" by 
typing "c*/J//<ortter>" and they 
all disappeared in a flash. The file 
now looked like it should. This 
was workable, but I felt I could do 
better. 

My CoCo presently has a 3 
1/2 inch, 720K drive as /d0. I had 
an extra 3 1/2 inch, 720K drive 
that 1 decided to install in the PT 
68K-4 case. I intended to make a 
CoCo compatible descriptor and 
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then be able to swap disks with 
my CoCo, which would make 
things much easier than the above 
procedure had been. I installed 
the drive and proceeded to make a 
new descriptor for it. I was using 
the same procedure that I had used 
to make the hard drive descriptor 
earlier. I had found the dl.a file 
in the IO directory and edited it 
to be for a 720K drive following 
the instructions in the file. Then 
I used the Make utility to create 
a new descriptor. I kept getting 
'Target file not found" error. This 
couldn't be. This had worked 
before on hG.a. Why not now? I 
decided to try making a new hard 
drive descriptor, just to test my 
syntax you understand. Same 
error, "Target file not found/' 
Okay, logic has to kick in here 
somewhere- When I had first 
made the hard drive descriptor, 
I had been working with only a 
floppy disk system. 1 went back to 
the disks, you know, did /dO/IO 
and chx /dO/CMDS, sort of make 
believe that the hard drive is not 
there. Guess what? IT WORKED! 
Unbelievable. 

Between the time that I 
bought and assembled the PT 68K- 
4 and the time I decided that 
I needed the CoCo compatible 
drive, I had attended the Middle 
America Fest 93, which was pre- 
sented by the Mid Iowa & Country 
CoCo Club, in Des Moines, Iowa. 1 
had received a disk from someone, 
whom 1 hope will forgive me for 
not remembering his name, which 
contained the OS-9/68000 version 
of Dmode. It seemed pretty obvi- 
ous to me that I had failed to put 
something on my hard drive that 
certainly was on my disks. Prob- 
ably due to the fact that I had one 
original version of the #1 disk that 
had messed up files on it and a sec- 
ond version of the #1 disk, which 
replaced those files, but may have 
not had everything else on it. I de- 
cided that I would format the hard 
drive and reload everything. It 
was only three disks. I had pur- 
chased Ved and Vprint but not yet 
installed them. I also purchased 
the demo version of G-Windows 



but had not installed that one ei- 
ther. It was just the three system 
disks. There should be no prob- 
lem, and "I better get everything in 
there working now before adding 
more and more files" I reasoned, 

I booted up with the original 
disk, no hard drive needed, I 
copied Dmode to the commands 
directory of that disk so I could 
use it. Okay, here we go, "dmode 
/hO<enter>" and up comes the 
dmode report for /hO, just like on 
the CoCo. I was in seventh heaven . 
My drive has 754 cylinders and 
11 heads. It had served me for 
several years on one of my CoCo 
setups. The dmode report showed 
that the stock descriptor had 614 
cylinders and 4 heads. Everything 
else was the same. I typed "dmode 
/h0cyl-2F2sid=0b<enter>". That 
should do it, I then typed "format 
/hO<enter>" and the format 



Then I came to 
tne "Do you want 

a logical format" 

ueshon. I said 






Yes" and wham! 

. m 

utility came up and showed me all 
the data it was going to use to for- 
mat this drive. It also warned me 
that it was a hard drive. I plod- 
ded forward. It asked "Did I want 
a physical format'' and I answered 
"Yes." Off it went, Some time lat- 
er it asked for a volume name and 
whether I wanted a "Logical for- 
mat". Again \ said "Yes" but then 
in an instant an error flashed on 
the screen. "Fatal error reading 
logical sector zero"! Now what 
was this? Let's try this again. "For- 
mat /h()<enter>" etc., etc. Bin- 
go, the same error. Had I messed 
up my hard drive when I installed 
the new floppy drive? Had I jig- 
gled the head on sector zero, mak- 
ing it unreadable? Could 1 be that 
unlucky? After several hours of 
checking and double checking, I 
concluded just that. It was time to 
buy another hard drive. 

I went to a local discount, 



used, computer junk, type store 
looking for a bargain. I found 
another 72 Meg hard drive. This 
one happened to be a half height 
drive. That would even fit into the 
case I had a lot easier. The whole 
thing would end up lighter also, 
a consideration when you bring 
your system to the club meeting 
every month. This drive also 
presented one other problem. It 
had 1170 cylinders and 7 heads. 
These are MFM drives using XT 
hard drive controller cards just like 
the Burke & Burke CoCo XT-RTC 
adapter I had on my CoCo. In 
fact, the hard drive controller card 
I was using had come from the 
same CoCo setup that the Hrst hard 
drive had come from. 1 knew that 
this meant that I could only use 
1024 cylinders, a limitation of the 
XT cards, not a limitation of OS-9. I 
wasn't happy , but I could live with 
that. 

I removed the original full 
height hard drive and replaced 
it with the new half height. I 
got everything plugged in, dou- 
ble checked everything, and 
fired it up. I booted, as be- 
fore, with the disk system, us- 
ing the CoCo as the terminal. 
So far so good, i typed "dmode 
/h0<enter>" and the same report 
I had seen before came up. This 
time I typed "dmode /hO cyl-400 
sid=07<enter>". Looking good, so 
I typed "format /h0<enter>" as 
before. Same questions, same an- 
swers, everything seemed to be 
working correctly. Then i came to 
the "Do you want a logical format" 
question. I said "Yes" and wham 1 
"Fatal error reading logical sec- 
tor zero"! Now I ask you, do you 
believe that I could have bought 
another drive that just happened 
to have a bad logical sector zero? 
Naw, well . ., naw, couldn't be . . 
. could it? 

I was getting desperate. I 
placed a call to Peripheral Tech- 
nology. Could Frederic be there 
on a Saturday? Maybe my luck 
was about to change. Frederic was 
there. I whined, I cried, I tried to 
explain. Frederic concluded from 
my explanation, full of assurances 
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that "I had been using OS-9 for 
years, I knew what I was doing. I 
couldn't be doing it wrong" that 
maybe my hard drive controller 
card was bad. It sounded reason- 
able to me. With many thanks, I 
hung up and got ready to go out 
and buy another hard drive con- 
troller card. Not an easy task on 
a Saturday afternoon, but I found 
one. 

Here we go again. I was lucky 
once more. 1 got a hard drive 
controller card that was the same 
model as the original card that [ 
was using. Easy to know how to 
configure the jumpers that way. 
1 did have the documentation for 
that model. Unfortunately, same 
story, same day, same results 
"Fatal error reading logical sector 
zero" came back to haunt me. 1 
was really pulling my hair out, 
'This is not possible/* I said over 
and over. Tim was like a roller 
coaster ride that I didn't want to be 
on. I needed a plan and I needed it 
fast. 

The original 72 Meg, full 
height, hard drive had been in a 
CoCo system, working, just a few 
weeks ago. The whole thing was 
still sitting here on the table. I de- 
cided to put it ail back together 
and see what happened, i plugged 
the original hard drive controller 
card into the Burke & Burke CoCo 
XT RTC and connected the cables 
for the hard drive. I then reassem- 
bled the case. I put the hard drive 
back into its case and plugged in 
the power supply cable and the 
controller cables from the Burke 
& Burke. I had a boot disk, ]ust 
for this occasion, that would boot 
without need for the bard drive 
but does have the hard drive de- 
scriptors in memory. In fact, I 
have one of these for each of my 
systems. I fired it up. All went 
well. The system came up run- 
ning. I was a tad impatient by 
this time and knew it would take 
a long time to format this drive on 
the CoCo system. I didn't want to 
wait. I used dmode to change to 
10 cylinders, 4 sides. I typed "for- 
mat /hO<enter>". In a very short 
time I got the familiar question and 



gave my answer. "Yes, I did want 
a logical format", at least I hoped 
I did. Bing, bing, bing, just like 
clockwork, the drive stepped out 
and formatted and my prompt re- 
turned, I apprehensively typed 
"dir /h0<enter>", I got the famil- 
iar report of an empty directory on 
a freshly formatted disk. Fantas- 
tic, it had worked. The drive was 
okay. Could the new drive also be 
okay? Just a few minutes swap- 
ping the two drives, and I had the 
answer, YES! I had not wasted my 
money. The new drive was good. 
Could the new hard drive con- 
troller card be good also? You bet, 
good as gold. 

Three days previous, f had 
placed a call to my very good 
friend Lee Veal We have trav- 
eled to several Fests together and 
spent many hours in the car dis- 
cussing OS-9. He has an excellent 
understanding of OS~ ( > and many 
years of experience to go with it. 
He had been out of town, and his 
wife had given him the message 
when he returned. He called me 
Sunday evening. I told him this 
sad story that I have just told you. 
By the time we got to this part, he 
was laughing out loud. In fact, 
he was roaring. I didn't see any- 
thing funny at all. 1 was begin- 
ning to think that there was some- 
thing wrong with my new com- 
puter, and that was not some- 
thing I wanted to hear. When Lee 
finally calmed down, he had the 
ans wer. Remember the key phrase 
following the instructions earlier? 
Well, I had swerved from this 
road just a little. I had decided to 
use Dmode to set the descriptors. 
After all, once I set them, 1 could 
have saved them to the BOOTO- 
BJS directory for making a boot- 
disk using Os9gen. For those of 
you who do not have OS-9/68000, 
this is like the MODULES directo- 
ry on the CoCo. I knew this would 
work. What I forgot is that Dmode 
expected me to be smart enough to 
realize that computers start count- 
ing from zero (0) and humans start 
counting from one (1). My mis- 
take, pointed out by my friend Lee, 
had been two foal but caused the 



same error. On the first drive, 754 
had been the actual last cylinder. 
The real end of the line. The com- 
puter would call that 753. Since 
I called it 754, when the head got 
to the end it did the next logical 
thing. It went right back to sector 
zero. Somewhere on the drive cir- 
cuitry there must be a counter that 
says 753 plus one, rolls right back 
around to zero. When I format- 
ted the drive, the last track writ- 
ten was actually on top of the first 
track written, logical sector zero, 
effectively wiping it out by writ- 
ing data for track 754 on top of it. 
When format tried to check out the 
format and write the logical data to 
the tracks, it found no sector zero 
to write to 

The second drive had suffered 
from a similar problem Even 
though it had less sectors than I 
specified and could not have rolled 
its counter, the hard drive con- 
troller card also has a counter. It 
has a limit of 1024 or actually zero 
(0) to 1023, The same thing hap- 
pened. When the drive got to track 
1 024, the hard drive controller card 
sent it back to track zero, effective- 
ly creating the same error as on the 
first drive. It also wrote right over 
the label for track zero. It looked 
like both drives were bad. 

Needless to say, this story has 
a happy ending. The FT 68K-4 
is up and running, with the new- 
er hard drive. The original, full 
height will be the backup or spare. 
1 am now progressing well with 
the FT 68K-4. In fact, although I 
started this story on the CoCo, us- 
ing Ved, I have completed it on 
the PT 68K-4, also using Ved, the 
68000 version. If there is any inter- 
est, I will write more stories about 
OS-9, the CoCo, and the PT 68K-4 
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The Soul of a 
New Machine 

The 68340 Accelerator Board 

for the MM /l 

by Mark Griffith 



The MM /I personal comput- 
er from Interactive Media Sys- 
tems has been available for exactly 
three years since making its debut 
at the Atlanta CoCoFest in Octo- 
ber of 1990. A little over a year ago, 
rumors started that a "speedup" 
board was in the works to re- 
place the Motorola 68000 compat- 
ible 68070 microprocessor. Dur- 
ing the Chicago fest in May, Kevin 
Pease, the designer of the MM /I, 
showed up with one of his ac- 
celerator boards. In the last five 
months, Kevin and Carl Kreider 
have been working to bring the ac- 
celerator to the public. Now, they 
are available and were sold at the 
Atlanta CoCoFest. \ asked Carl if I 
could get an advanced look at one 
of the boards, and he had Kevin 
Pease send one to review 

A few days later, a small box 
arrived with the accelerator board, 
a lou pie of ROMs, one V AL, a disk, 
and some instructions. The board 
itself, as seen on this month's front 
cover, is surprisingly sparse, There 
are only a few chips and other 
components, the main piece being 
the new Motorola 68340 CPU. 
This CPU is for the most part the 
equivalent of a 68020. There are 
some neumonics that are missing 
from its instruction set, but they 
are ones that are hardly, if ever, 
used. These are shown in table 1 
below. 




instruction 


Description 


bfchgclr 




bfexts 




bfextu 




bfffO 


bitfields 


bfins 




bfset 




bftst 




oatlm 


call module 


rhn 


rtn from module 


cas 


compare and set 


cas2 


compare and set 


pack 


pack BCD string 


unpk 


unpack string 



In addition, no coprocessor 
instructions are included either. 



The accelerator kit comes with 
many new modules to take ad- 
vantage of the increased speed. A 
list is shown on the next page. The 
new SCSI modules are designed 
to take advantage of the increased 
DMA capabilities of the 68340. 
The hard drive descriptors are for 
use with the new SCSI drivers. The 
new floppy disk driver (rb37c65) 
and the new serial I/O modules 
<sc68681, sc68901, and sc68340) in- 
clude several bug fixes from the 
last IMS updated versions, Also 
included is a new windio mod- 
ule, version 50, and new window 
descriptors. I'll have more to say 
about this new version later. 

As noted in the included in- 
structions, you must make a new 
boot disk with the new modules 
BFFORE installing the accelerator 
board. If you do not, you won't 
be able to boot from youv old boot 
disk. The instructions I received 
were not the final copy and did 
not provide enough information 
to make a bootable disk. This re- 
sulted in my having to de-install 
the accelerator board, reinstall the 
old ROMs, put the boards back 
together, reboot under the 68070, 
and then make another accelera- 
tor boot disk. I had to do this sev- 
eral times to get it right. One thing 
that was not mentioned was that 
the new stdfont module must be 
included in the boofcfile, as well as 
the cio and math modules. This 
h3S been corrected in the final ver- 
sion of the included documenta- 
tion by giving an example bootlist 
file of which modules to include. 

Installation of the accelerator 
board was simple. I removed 
the I/O board and used a special 
PLCC device puller to remove 
the 68070 from the socket. The 
included instructions describe 
how to make a chip puller from a 
large paper clip, but I preferred to 
use the puller. Although the paper 
clip puller will work, I would 
recommend using extreme caution 
when doing this if you ever want 
to reuse the 68070 again. Kevin 
Pease yanks them out like a dentist 
pulling teeth, but he is apparently 
luckier than I am. 
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I then inserted the acceler- 
ator board into the empty sock- 
et and removed and replaced the 
two ROMs with the new versions. 
This brings up another caution. 
IMS originally shipped their distri- 
bution disks with some OSK ver- 
sion 2.3 commands installed, no- 
tably the format utility and the 
cio trap handler. Users never no- 
ticed this because the version 2.4 
modules were also included in the 
ROMs along with a host of other 
well used utilities, like COPY, DIR, 
and so on. Of course, OS-9 would 
always use the modules already in 
memory rather than load an older 
one from disk. The problem is, the 
accelerator ROMs do not include 
anything other than the boot code. 
No utilities or trap handler mod- 
ules, and no debugger. 

If a user installs the acceler- 
ator board and ROMs, boots up, 
and tries *o format a hard drive 
with the version 2.3 format: utili- 
ty, it won't work. The same applies 
to any applications that used the 
cio trap handler or old math mod- 
ules To make sure this doesn't 
happen, you need to check ail the 
modules in ROM on your 68070 
machine with the same modules in 
your commands directory. If they 
are not the same, save the module 
in memory to disk using the SAVE 
utility. Once you have made sure 
all your commands directory mod- 
ules are the latest version, you can 
proceed 

After installing the ROMs, 1 
reassembled the two boards and 
found that the I/O board could not 
be securely fastened to the moth- 
er board standoffs without flexing 
it too much. The accelerator board 
protruded too far from the sock- 
et. After speaking to Kevin Pease 
about this, we found that by break- 
ing off the four little seats in the 
bottom of the 68070 socket, the ac- 
celerator board would fit deeper 



New Modules 


cio 


dd.hO 


ddhOa 


dd.hOfmt 




hO 


hOa 


hOb 


hOc 


hOd 


hOe 


hOf 


hOfmt 


hOg 


hi 


hla 


hlb 


hlc 


hid 


hie 


hlf 


hlfmt 


hig 


h2 


h2fmt 


hSfmt 


h6 


h6fmt 


h7 


h7frat 


init 


kernel 


keydrv 


math 


msdrv.90t 


P 


rb37c65 


rbvecs 


sc68340 


sc6868I 


sc68901 


sesLmmla 


stdfonts 


to 




t5 


term 


w 


wO 


wl 


wio 


wii 


wl2 


wl3 


w!4 


wl5 


w2 


w3 


w4 


w5 


w6 


w7 


w8 


w9 


windio 



into the socket and allow the 
two boards to be connected again 
without undue flexing. However, 
if you do this, don't plug your 
68070 back into that socket or it 
will fit so deeply inside you might 
not get it back out again! i found 
out and if it were not for that 
special PLCC chip puller, I'd be 
stuck running an '070 system. 

Once 1 had everything in- 
stalled correctly, I powered up the 
machine and noticed the new boot 
prompt also includes the speed at 
which the CPU is running. In this 
case, I started with the lowest set- 
ting, 1 1.98 Mhz, As I mentioned 
before, once I got ail the correct 
modules included in the boot file, 
the machine booted normally . 

The first thing f noticed was 
my mouse no longer worked. The 
keyboard mouse didn't work ei- 
ther Apparently, Kevin Pease has 
a Logitech mouse and the mouse 
driver only supports that model I 
have a Logitech compatible mouse 
and it does not work with the 
new driver. Kevin was not aware 
of this problem and is in the pro- 
cess of fixing the driver. To pro- 
vide a temporary fix, I unplugged 
the mouse from the / 12 socket and 
the keyboard mouse then worked. 
Also, the current mouse driver is 



set to work only on the /t2 port. 

There were some other prob- 
lems. The new version of win- 
dio was "broken" again and many 
graphics applications did not 
work. The problem seemed to be 
with changing palettes. Kevin 
Pease was aware of this and has al- 
ready contracted someone to work 
or it. in addition, there is no sound 
driver for this new version, so even 
the keyboard beep doesn't work. 
Again, someone has been con- 
tacted and new drivers should be 
available soon. As of this writing, 
I do not know the date when they 
will be available. 

Now that the system was 
running, I could perform some 
simple tests. I decided to run tests 
that were easily measured, but 
still reflected tasks that would be 
done during everyday operation 
of the machine. All of these 
tests involved memory intensive 
operations, since disk or serial I/O 
would not be effected greatly, if 
at all. The chart below shows the 
results of the tests at four different 
CPU speed settings. I included a 
dhrystone test just as a means of 
plotting raw performance. 

The extract test involved 
using the Ika utility to extract a 
rather large archive of files. The 



Test 


68070 


11.98 




14.75 




16.59 




20.28 




Dhyrstone 


1020 


1612 


1.58 


1666 


1.63 


2083 


2.04 


2777 


2.72 


Extract 


71 


50 


1.42 


43 


1.65 


41 


1.73 


37 


1.92 


Archive 


192 


125 


1.53 


105 


2.83 


86 


2.23 


76 


2.53 


Compile 


400 


253 


1.58 


213 


1.88 


188 


2.13 


163 


2.45 


List 


136 


130 


1.05 


104 


1.31 


96 


1.42 


93 


1.46 
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archive test was archiving all the 
files just extracted. The compile 
test was using the standard 'C 
compiler to compile all the sources 
for Sterm 1.5.1. The list test 
was simply listing a 58k file to 
the screen, All the test results, 
except for the dhrystone test, are 
displayed in elapsed seconds. 
The dhrystone test results are the 
number of dhrystones completed 
in one second. 

At 11,98 Mhz, the MM /I was 
slightly faster, but nothing to brag 
about. Since the stock MM/1 runs 
at 15 Mhz, I decided to try a CPU 
speed as close to that as possible, 
14.75 Mhz, 1 then tried 16.59 Mhz 
since this is the recommended 
setting for the production units. 
The 20.28 Mhz tests were done 
to test the ability of this increased 
speed on the components of the 
I/O board, i was able to run at 
this &pced because the unit I was 
testing was the original prototype 
and had a 68340 installed that was 
rated at 25 Mhz. Production units 
are all rated at 16 Mhz. increasing 
the CPU speed above that, while it 
is possible, is not recommended by 
the designer. 



The "feel" of the MM/1 with 
the accelerator installed and run- 
ning at 16 Mhz made it like a new 
machine. Applications snapped 
on the screen and flipping through 
pages on the text editor was light- 
ning fast. Everything felt crisper, 
smoother, and more powerful. 
What graphics applications I was 
able to test were substantially 
quicker. 

In spite of the initial problems 
and the work that is still need- 
ed on the software, the accelera- 
tor board is a much needed ad- 
don for any MM/1 owner. Kevin 
Pease and Carl Kreider are com- 
mitted to providing the customer 
support today's users are accus- 
tomed to having. Most of the prob- 
lems identified were due to the 
rush in getting the product to the 
customers. As is too often the case 
in this market, the developers ate 
doing this in their spare time (if 
there is suck an t king-Ed.) and not 
as much time is devoted to test- 
ing as should be. You can't blame 
them for trying to keep up with 
the larger developers, considering 
the work load they carry and what 
they are trying to do. 



Why should someone buy an 
accelerator? Well, if you are a de- 
veloper, the increased speed of 
compiles will save you much time. 
For those working on graphics or 
sound processing, a 2.5 time in- 
crease in speed would work won- 
ders. For the average user, al- 
though there would be no in- 
creased speed in serial I/O or disk 
access, the more advanced SCSI 
and serial drivers would mean in- 
creased reliability. 

Both Kevin Pease and Carl 
Kreider should be praised for their 
efforts. A lot of time, energy, and 
money when into development of 
this device. Putting the problems 
mentioned aside, this is a quality 
product with good support that 
will make any MM/1 owner 
happy. It taily is the soul of a new 
machine. 

The accelerator board can 
be bought from BlackHawk En- 
terprises, P.O. Box 10552, Enid, 
OK 73706-0552, 405-234-2347. 
Get one-it'll be worth it. 



DISTO Products 



!-Meg Kit . $99,95 

Kit iq upgrade COCO 3 to 2 mega-bytes of memory. 
Requires soldering experience and two 1 meg x % memory 

SIMMs. 



3IN1' 



$70 



This adapter fits into any device thai has a MEB and has a 
real tune clock, parallel printer port aixi a serial port, 
Includes OS9 drivers. 



scu* 



SCI 



4IN1 



The Super Controller a has a NO-HALT mode for OS9. 
Comes with OS9 drivers and one MEB (Mini Expansion 
Bus), 



$130 



$100 



The original Super Controller comes with 4 DOS sockets 
and one MEB. 



, $100 

This adapter fits into the SCIJ or the MEB-H and has a real 
time clock, parallel printer port, serial port and a SCSI 
hard disk port. Includes OS9 drivers. 3 Cable set $30. 



HDU * $75 

This MEB adapter has a SCSI hard disk port and a serial 
port. Includes OS9 drivers. 

MPROM $50 

This MEB adapter programs 2764, 27128 or 27256 
EPROMs. Includes RS DOS drivers. 



FTOS 



$20 



"Full Turn of The Screw" book has all Rainbow articles 
from j an '83 to Jul *89. 



SCHEMATIC SET $20 

Schematic diagrams for all COCO 3 DISTO products 
except the 1 & 2 meg upgrade kits. 



All DISTO products come with a 3 month limited warranty. Items marked with an * are refurbished or 
repaired units. Include $4.50 for shipping and handling for one item or $6.50 for two or more items. Send 
certified cheque or money order only to; 



DISTO 1710 Depatie, St. Laurent, Quebec Canada H4L 4A8. (514) 747-4851 
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BASIC Programming 
PART 1 - VARIABLES 



By Don Vaillancourt 



Don, owner of CANAWARE, has been using a Color 
Computer for the past eight years or more. Most of his 
time is spent programming under Q$~9 Ijzvei II on his 
CoCo3. His many hobbies include a/cling, programming 
and "BBSing". 

This is the first of a series of articles I will be 
writing to help computer users to program efficiently. 
The examples that I will be using revolve around 
BASIC09, Microware's version of Basic. I find BASIC 
to be the most powerful multipurpose programming 
language in the world today. Granted it's not as fast 
as C or assembly language or quite as intricate as 
Pascal, but when you look at the number of commands 
available and their wide variety of uses and flexibility, 
you begin to wonder why it is only an entry level 
programming language. Basically, once you master 
BASIC, your only limiting factor becomes your 
imagination. 

Different people view programming in different 
ways. Some program to obtain results in their 
favor, others program because they want to share 
their ingenuity with others. Then there are the ones 
that do it for money and still others do it because it 
becomes an art. I think that these four factors represent 
programmers very well. Although one attribute may 
overcome another, over time they seem to change, 

VARIABLE DIMENSIONING 

In tins article I will look at variable dimensioning. 
Sure, you may think that variable dimensioning is the 
most boring subject of programming, but often the 
most boring becomes the most important because it is 
responsible for the conduct of an operation, which in 
this case is your program. 

One thing that gets overlooked in programming is 
that variable names in today's languages often support 
a minimum of 8 significant characters to identify a 
variable and some may ailow up to 32 significant 
characters, unlike the older programming languages, 
specifically the ROMed basics, which allowed a 
maximum of only two. 

When defining a variable, use the most definitive 
word to define its use. Make your variable names 
as unique as possible and as long as needed, 
remembering the maximum number of significant 
characters allowed. Usually, a variable name should 
be between 8 to 20 characters long, or a full word, but 



no longer than 32. There are exceptions to this rule, 
which we'll cover later on. 

Also keep in mind that most languages only 
allow the alphabetical letters (upper and lowercase), 
numbers, the dollar sign '$' and the underscore '„' to 
be used as part of a variable name. Some languages, 
such as COBOL, will allow other characters as well 
such as the hyphen '-', and other BASIC languages 
use the percent sign '%' and other deliminator type 
characters to identify a variable type. 

One character that should never be used is 
the period 7, because this character separates a 
parent element from its child element in record type 
variables. 

One rule that should never be forgotten is that 
all variables must start with an alphabetical character. 
That is a letter from A to 2 in upper or lower case. 

For example, you may define the variable AGE 
to store a person's age, or MEN^ AGE to store a man's 
age. Or define the variable NAME to store a person's 
name or FIRST_NAME and LAST NAME to store a 
person's first and last name respectively. 

As noted above, the variable name 1 COUNT 
would be illegal, Because the first character is a 
numeric character, the interpreter or compiler would 
assume that you want to use a number when in fact 
you have a variable name, which in turn confuses the 
interpreter or compiler. 

Here are more examples: 



MONTH! 2 


legal 


7 DAYS 


ill ega 1 , f i r s t cha r 




a number 


name$ 


leg a 1 


tfY-Name 


leg a] * 


&Ti?K\S 


i 1 1 eg a 1 , first. cA \ a r 




t i o t a 1 pha he 1 1 c a 1 


ADURI''SS_ 


1 egai 


HTS_AGE% 


legal * 


T.ITijK$STR 


illegal, the dollar 




sign '$' must be at 




end 



First, check your programming language manual 
for the variables with the '** to see if they are 
supported. If not, then stick with the basics of letters 
first, numbers, underscore '_' and dollar sign '$'. Just 
thought I'd note that older basic interpreters did not 
support the underscore '_'• 

VARIABLE TYPES 

There are basically five types of variables. They 
are STRING, BYTE, INTEGER, REAL and BOOLEAN. 
But be careful because not all programming languages 
are created equal. Most languages will use the above 
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five, but some Pascal languages don't use the BYTE 
definition. 

The old ROMed basics did not use any of the five 
types. They used the dollar sign '$' to identify a string 
and no dollar sign '$' or maybe the percent sign '%' to 
identify a real variable. 

The COBOL language uses the PICTURE 
statement and a series of 9*s and the letter "? to signify 
a real variable, and more 9's to define the decimal 
accuracy, the letter 'X' to define a string, or 'A' to 
define a string with alphabetical characters only. 

The STRING definition will cause a variable to be 
able to store 1 to N characters, from decimal value 
to 255, By using the single 'quote' or double '"quote", 
you can store printable characters in a string or the 
CHR$ command to store any character codes between 
and 255 inclusive. 

The BYfE definition is 8 bit large and will hold 
a value between and 255 inclusive. INTEGER is 2 
bytes large or 16 bits and can hold a value between 
-32768 and 32767, On larger systems and some 
programming languages it can be 4 bytes large. REAL 
on the other hand, is five bytes, which is quite large, 
and again can be up to 10 bytes large, and can hold 
values from (-1 X 10 -38) to (1 X 10 38), 

BOOLEAN types are quite useful; it creates a 
condition variable. Conditions based upon whether 
the results of the variable is true or not. A variable 
defined as BOOLEAN can hold the values TRUE or 
FALSE only. Although it may seem primitive, it helps 
a lot to organize one's programming capabilities. 

Which ever way your language defines a variable, 
always remember a variable's maximum storage 
capacity when defined. Don't try to store a value 
larger than 255 in a BYTE type variable, or don't hope 
that a string defined to hold 10 characters will hold 
11. 

In some languages, there are usually one or two 
variable types which don't have to be defined, since 
they are defined automatically when first used. In 
some cases this may be all right, but [ always make 
sure that I've denned my variables at the top of 
ray program. That way if there is a problem in the 
program's execution with a variable, I can always 
check at the top of the listing to see how that variable 
was defined. Also, it helps others foreign to your 
programming style and your languages capabilities 
and rules. 

Another way to help your programming is to use 
the dollar sign '$' at the end of any variables that you 
define as string. Although not necessary in most high 
level languages, it can help any programmer who gets 
lost easily in his programming. 

Here are some examples of variable definitions: 

DIM COUNT : INTEGER REM NBR OF TUP MS TAKEN 
DIM NAMES: STRING [32] REM PERSON'S NAME 



DIM MY^AGEiBYTE REM THIS IS MY AGE 

DIM PETS: INTEGER REM *NBR OF PETS 

DIM CAPITAL: REAL REM CAPITAL I INVESTED 

DIM FLAG: BOOLEAN REM TRUE IF DONE, ELSE FALSE 

If you program with a group of people or you 
know that your program will be read by others, you 
might want to explain a variable's use by using 
the REM statement. That way when the variable is 
encountered in the program the other person will have 
an idea of what you're trying to do. It is also a good 
reminder for yourself as well of what you were doing. 
A programmer's style evolves over time / especially if 
he/she didn't know what they were doing at the time 
of the program's conception. 

MULTI-DIMENSION VARIABLES 



Muitidimensioning variables is easy but 
sometimes requires large amounts of memory. In 
physical terms it's hard to explain a multid tmensional 
variable, especially when you get to four and five 
dimensions and beyond. Let's try. A one dimensional 
variable can best be described as a straight line cat into 
several segments from 1 to N. Such as: 

DIM MONTHS (12) ; STRING ! 1 4 1 



The number between the parentheses represents 
the number of elements in the variable, which in this 
case is equal to the number of months in a year, 12. 
Since each month occurs one after the other, it can be 
defined as one dimensional, where: 

MONTHS { i ) ----JANUARY 
MONTHS { 2 ) --= FEBRUARY 
MONTHS {3} -MARCH- 
MONTHS ( 12) --DECKMBER 



A two dimensional variable could be defined as a 
Tic-Tac-Toe grid. Using this format: 

DIM GRID {3, 3) : STRING [1 J 



A Tic-Tac-Toe grid is made up of 3 columns and 
3 rows, where the first digit (called a subscript) of 
GRID represents columns and the second subscript 
represents rows. Therefore for each column there are 
3 rows. 

GRID{l,i)^X I GRID{2/n-0 ! GRID (3 , *1 ) -=0 
CRID(1,2)=X ! GRID<2,2}-X | GRID (3 ,. 2) -0 
GRID(1,3}~~0 i GRID(2,3)=--0 I GRID{3,3).-=X 

A three dimensional variable can be viewed as 
a Rubik's Cube. The first subscript is the width, the 
second subscript is the height and the third is the 
depth. Or in any order easily understood. 
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DIM RUBIK_CUBE (3,3,3): STRING [ 1 ] 



ROBIK_CUBE 



subscript 2 



subscript V 



y 


V / / 


/ 


/ / 


/ 


/ 


Vy^y^ 


S 










/ 














V 



& 



1 2 

»ub«so"ipc S 



variable ru*» of WiBIK„CUBE(J» 3,3* 



Another way to look at the RUBIK_CUBE variable 
is as a tree. Remember that the first subscript is the 
parent of the second subscript, and that subscript is the 
parent of the next subscript and so ox\, iust like a family 
tree. See figure lb to get a better idea of what I mean. 



at 1, and there are some that are adjustable. BASICQ9 
can be adjusted to be either or 1 by using the BASE 
statement. When defining a variable in PASCAL, you 
must specify the first and last subscript of the variable. 
In the examples above I assumed that the base was 1, 
but had it have been 0, all subscripts would be 1 less 
when the variable was addressed. 

CREATING RECORD TYPE VARIABLES 



Creating record type variables is quite easy. 
Again, each language is quite different when creating 
such variables. BASIC uses the TYPE statement, 
although some of the older ROMed basics didn't have 
a TYPE statement implementation. PASCAL uses 
TYPE as well, C uses the statement STRUCT, and 
COBOL uses incrementing numbers to define a master 
variable, its elements and those elements' elements. 

Record type variables are used when dealing with 
files for storing or retrieving a set number of records. 
Also they can be used w\\qi\ transferring lots of mixed 
information to a subroutine. Here is an example of 
what a record type variable looks like. 

17YPE POJpr^ FTI^ r1 / JfoAMKS, LA3T_NAME£; STRING [1M ; 

a::i: .■ rv tf. •, gknoe'k : hog;,i<:an 







Ru»iK_cy»e 






woscrtpt: x 


1 2 J 






^ 


--'"' 


^ 


"^ 


iiotrtcr tpt 











/ \ 



subscr mt ~L \ 



X 2 3 

/ I ^ 
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figure lb 
variable tr*« of RUBIK„CU8e(3<3, 3 » 



Variables can be dimensioned in any size ycu 
want with as many dimensions as you need. But 
some languages are very restrictive to the number 
of dimensions you can use. And remember, for each 
dimension you add, you greatly increase the amount 
of memory by that multiplied dimension value. 

One thing you should be aware of is what the first 
element value of your dimensioned variable is. Some 
language's first element may start at and some start 



Here the type definition represents four variables, 
a person's first name, last name, age and then their 
gender or sex. But since PEOPLE is a type definition, it 
cannot be used a s a variable. PEOPLE will be regarded 
the same as STRING, BYTE, INTEGER, REAL and 
BOOLEAN are regarded, as a type definition. 

To use PEOPLE it must be defined into a variable 
and can be used more than once. 

DIM PERSON: PEOPLP 
DIM STUDENT: PEOPLE 

Now the variables PERSON and STUDENT 
represent PEOPLE. To access all of PEOPLE'S 
elements you must use the period '/. 

PERSON. FIRST„NAME$ --DON 

PERSON . LAST_NAME$-- VAILLANCOUPT 

PERSON. AGE---2 3 

PERSON. GENDER-TRUE REM IN THIS CASE 
TRUE MEANS MALE AND 
FALSE MEANS FEMALE 

You can do the same with the STUDENT variable 
and any other variables that were defined with the 
same type. 

One problem with types is that a variable 
defined in a type cannot be redimensioned as a 
totally different variable, that is as a stand alone 



•19- 



- Metamorphosis - 



or part of another TYPE statement. It will cause 
a variable already dimensioned error such as the 
example below after the TYPE statement above was 
defined. 

DIM FIRST„NAME$ : STRING [ 16 ] 



One way that I learned to remedy this problem 
was in my COBOL class in college. The solution is to 
use parts of the type definition name in its elements. 
For the TYPE example above, you could redefine it 
as: 

TY PE PEOV L5= PEO..F I K£>T_NAME$ , PEO...LAST_NAME$ : STR ING U 6 ] ; 
PfcO_AGE: BYTE; PEO„GKNJDER : BOCLBAN 



One thing that's great about TYPEs is that they 
can be nested together. It's a great way to organize 
your data storage and to make your TYPE definitions 
more readable. Again this technique is used greatly in 
COBOL, COBOL allows you to group similar variables 
together, an example follows. By the way, this is one of 
the reasons why COBOL is still greatly used and why 
I like it so much. 

Ul 9EOPLK-PECORD. 

02 PP &AMFJS FARTS. 

5 PR -NAME C - F IRST NAME PTC x ( i f, ) . 

OS PR -NAMES -LAST -NAME PIC X{16) , 

02 PR -AGE PIC 9(02) . 

02 PR -GENDER PIC A (01) . 

The way you could convert this to BASIC is like this. 

TVPS HA ME PARTS -NP„FlP ST NAME$, NP >AST_NAME$ ■ STRIJW 116 J 

TVPS PEiVLE_ RECORD- PR ..HWES -NAHF„ PARTS ; PR_ AGE . BYTS ; PR RENDER : BOOLEAN 

01 M PEOPLE iPEOPLJJ__5i:CORD 



To access Nl*_FIRST_NAME$ or 

NP LAST _NAME$, you'd have to first access the first 
type first and then the second type just like this. 

LET PEOPLE , PR_NAMES . NP_FIR3T_NAME$---TON 



I didn't want to confuse you before, but here is 
one of the exceptions to the rule of variable names 
we discussed earlier. Over time there are non-verbal 
agreements made between programmers. What I 
mean by non-verbal is that one programmer picks it 
up from another programmer's code and so on and so 
on. 

Regarding variable names the exceptions are T 
and 'J' which represent general purpose incremental 
and decremental variables for the FOR..NEXT loops 
as well as REPEAT...UNTIL and other types of 
conditional loops. 

The variables 'X', 'Y' and 'Z' represent their uses 
as co-ordinates in graphics most of the time or other 
multidimensional areas. 



Sometimes the variable 'C is used in C (the 
language) as a means to carry one character from an 
input function to a larger variable. 

There are other exceptions as well, but most of 
them you will pick up as your programming skills 
become more proficient. 

Anyway, that's it for this month. Hopeful- 
ly, I'll have another article next month to cov- 
er something else, maybe modular program- 
ming, or trie basic structure of a program. 
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Dirt Cheap Computer Stuff Company 

"Cheap, but not trash" 

Announcing Two New Applications for the MM/1 

Speedisk Version 1.10 - $99.95 

and 

CirCad Version 1.0 - $79.95 

Speedisk is a disk optimizer/defragmentator for the MM/1 aad ail OSK roachkes. 0{jimiz#your hard drive 
in minutes, not days! Supports a full screen display on the MM/1. Commercial versitns aviilablfcsoon 

CirCad, the most complete electronic circuit designing package for the MMfl, hekis yoi desiin peii?ct 
schematics the hrst time! Creates a Postscript output file ihat cdh be printed on a laser pinten or uflng 
Ghostscript, on your dot-matrix printer. 

Please call 3 1 4-583- 1 168 for more details. Also call about oiff other software and hardware pitoducfl for CK J ) 
and OSK, such as InfoXpress, floptical drives, CDROMs, add higl speed modems AH dialers add $5.0$ for 
shipping. Check or money order only please. 



Dirt Cheap Computer Stuff Co. 
1368 Old Highway SO East 
Union, Missouri 63084 
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